home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / gfx / pbm / manuals.lha / netpbm / man / ppmtoilbm.man < prev    next >
Text File  |  1994-03-01  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4.      ppmtoilbm(1)         AMIGA (31 October 1993)         ppmtoilbm(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ppmtoilbm - convert a portable pixmap into an ILBM file
  10.  
  11.      SYNOPSIS
  12.           ppmtoilbm [-maxplanes|-mp N] [-fixplanes|-fp N] [-ham6|-
  13.           ham8] [-dcbits|-dcplanesrg [-normal|-hamif|-hamforce -
  14.           dcif|-dcforce|-cmaponly] [-ecs|-aga] [-compress|-nocompress]
  15.           [-cmethod type] [-mapppmfile] [-savemem] [ppmfile]
  16.  
  17.      DESCRIPTION
  18.           Reads a portable pixmap as input.  Produces an ILBM file as
  19.           output.  Supported ILBM types are:
  20.  
  21.           Normal ILBMs with 1-16 planes.
  22.  
  23.           Amiga HAM with 3-16 planes.
  24.  
  25.           24 bit.
  26.  
  27.           Color map (BMHD + CMAP chunk only, nPlanes = 0).
  28.  
  29.           Unofficial direct color.
  30.                1-16 planes for each color component.
  31.  
  32.           Chunks written:
  33.                BMHD, CMAP, CAMG (only for HAM), BODY (not for colormap
  34.                files) unofficial DCOL chunk for direct color ILBM
  35.  
  36.      OPTIONS
  37.           Options marked with (*) can be prefixed with a "no", e.g.
  38.           "-nohamif". All options can be abbreviated to their shortest
  39.           unique prefix.
  40.  
  41.           -maxplanes | -mp n
  42.                (default 5, minimum 1, maximum 16) Maximum planes to
  43.                write in a normal ILBM.  If the pixmap does not fit
  44.                into <n> planes, ppmtoilbm writes a HAM file (if -hamif
  45.                is used), a 24bit file (if -24if is used) or a direct
  46.                color file (if -dcif is used) or aborts with an error.
  47.  
  48.           -fixplanes | -fp n
  49.                (min 1, max 16) If a normal ILBM is written, it will
  50.                have exactly <n> planes.
  51.  
  52.           -hambits | -hamplanes n
  53.                (default 6, min 3, max 16) Select number of planes for
  54.                HAM picture.  The current Amiga hardware supports 6 and
  55.                8 planes, so for now you should only use this values.
  56.  
  57.           -normal (default)
  58.                Turns off -hamif/-24if/-dcif, -hamforce/-24force/-
  59.                dcforce and -cmaponly.  Also sets compression type to
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/1/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ppmtoilbm(1)         AMIGA (31 October 1993)         ppmtoilbm(1)
  71.  
  72.  
  73.  
  74.                byterun1.
  75.  
  76.           -hamif (*)
  77.  
  78.           -24if (*)
  79.  
  80.           -dcif (*)
  81.                Write a HAM/24bit/direct color file if the pixmap does
  82.                not fit into <maxplanes> planes.
  83.  
  84.           -hamforce (*)
  85.  
  86.           -24force (*)
  87.  
  88.           -dcforce (*)
  89.                Write a HAM/24bit/direct color file.
  90.  
  91.           -dcbits | -dcplanes r g b
  92.                (default 5, min 1, max 16).  Select number of bits for
  93.                red, green & blue in a direct color ILBM.
  94.  
  95.           -ecs (default)
  96.                Shortcut for: -hamplanes 6 -maxplanes 5
  97.  
  98.           -aga
  99.  
  100.           Shortcut for: -hamplanes 8 -maxplanes 8
  101.  
  102.           -ham6
  103.  
  104.           Shortcut for: -hamplanes 6 -hamforce
  105.  
  106.           -ham8
  107.                Shortcut for: -hamplanes 8 -hamforce
  108.  
  109.           -compress (*) (default)
  110.  
  111.           -cmethod none|byterun1
  112.                Compress the BODY chunk.  The default compression
  113.                method is byterun1.  Compression requires building the
  114.                ILBM image in memory; turning compression off allows
  115.                stream-writing of the image, but the resulting file
  116.                will usually be 30% to 50% larger.  Another alternative
  117.                is the -savemem option, this will keep memory
  118.                requirements for compression at a minimum, but is very
  119.                slow.
  120.  
  121.           -map ppmfile
  122.                Write a normal ILBM using the colors in <ppmfile> as
  123.                the colormap. The colormap file also determines the
  124.                number of planes, a -maxplanes or -fixplanes option is
  125.                ignored.
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/1/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      ppmtoilbm(1)         AMIGA (31 October 1993)         ppmtoilbm(1)
  137.  
  138.  
  139.  
  140.           -cmaponly
  141.                Write a colormap file: only BMHD and CMAP chunks, no
  142.                BODY chunk, nPlanes = 0.
  143.  
  144.           -savemem
  145.                See the -compress option.
  146.  
  147.      BUGS
  148.           HAM pictures will always get a grayscale colormap; a real
  149.           color selection algorithm might give better results.  On the
  150.           other hand, this allows row-by-row operation on HAM images,
  151.           and all HAM images of the same depth (no. of planes) share a
  152.           common colormap, which is useful for building HAM
  153.           animations.
  154.  
  155.      REFERENCES
  156.           Amiga ROM Kernel Reference Manual - Devices (3rd Ed.)
  157.           Addison Wesley, ISBN 0-201-56775-X
  158.  
  159.      SEE ALSO
  160.           ppm(5), ilbmtoppm(1)
  161.  
  162.      AUTHORS
  163.           Copyright (C) 1989 by Jef Poskanzer.
  164.           Modified October 1993 by Ingo Wilken
  165.           (Ingo.Wilken@informatik.uni-oldenburg.de)
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/1/94)
  196.  
  197.  
  198.  
  199.